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Introduction 

This guide contains introductory, procedural, and reference 
information for users of the Editor software application. The 
Editor allows you to enter, edit, copy, store, and retrieve 
textual information on your workstation. 

To understand the procedures and information in this guide, 
you must be familiar with Burroughs Operating System 
(BTOS) Executive level operations. 

This guide contains three sections, three appendixes, and an 
index. 

Section 1 provides introductory information and installation 
procedures. 

Section 2 describes the Editor screen and provides 
procedures for basic text entry and edit. 

Section 3 provides procedures for more advanced editing 
operations. 

Reference Material 

This guide contains three appendixes with reference 
information: 

n Appendix A lists and explains error and status messages. 

D Appendix B is an alphabetical list of Editor command 
functions. 

n Appendix C is a glossary of Editor terms. 

Conventions 

This guide uses the following conventions: 

D caps and bolds Executive and Editor commands and 
function keys 

a hyphenates keys you use in combination; for example, 
CODE-V indicates that you hold down the CODE key and 
press the letter V. 
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Related Material 

For additional information on the BTOS and Executive level 
commands, you can refer to: 

D BTOS Operations Training Guide 

D BTOS Standard Software Operations Guide 



Section 1 m 

Overview 

The Editor is a software application that allows you to enter 
and edit text using the keyboard of your workstation. The 
text appears on the screen as it would on a typewritten 
page. 



Editor Capabilities 

The Editor text management capabilities include: 

n text development: 

D inserting, overtyping, and deleting text 

n one-step repetition and canceling of the most recent 
editing operation 

D selecting text for copy, delete, or move operations 

D copying/merging among Editor files 

D text search and replacement 

D inserting a byte in hexadecimal code 

D text display: 

a speedy cursor movement 

D line and page text scrolling 

n optional viewing of format codes 

D option of 80- or 132-column display (on workstations 
with the zoom capability) 

n help display of Editor commands 

n text storage and retrieval 

To activate the Editor, you execute the EDIT command from 
the Executive command level, after setting the path, if 
necessary. 
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1 -2 Overview 

Accessing the Executive Command Level 

You access the Executive command level from the SignOn 
form that displays after you turn on your system. Use the 
following procedure: 

1 Enter a user name in the User name field if your system 
requires one. 

2 If your system requires a password, press RETURN to move 
the highlight to the Password field and type the password. 

The password displays as a series of pound signs (#). 

Note: If your system requires a password and/or user name 
and you do not know them, contact your system 
administrator. 

3 To change the date or time, press RETURN to move the 
highlight to the Day/Date/Time field and type the time and/or 
date/day. 

4 Press GO. The system replaces the SignOn form with the 
Executive command prompt. 

If an error message appears after you press GO, the cursor 
and highlight appear at the problem field. You must reenter 
the field information and press GO again. 

Setting the Path 

You must set the system path to designate a default volume 
and directory before you activate the Editor. When you 
initiate a command or function, the system acts on the 
default volume and directory. 

To change the system's path, use the following procedure: 

1 At an Executive command prompt, type path and press 
RETURN. 

The system displays the Path command form. The 
highlight is on the [Volume] field. 

2 To change the default volume, type a volume or device 
name. Do not use square brackets. 
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3 To change the default directory, press RETURN to move the 
highlight to the [Directory] field and type the directory name. 
Do not use angle brackets. 

4 Press GO. The system's path is now to the volume and 
directory you specify. 

For more information on setting the path, refer to the BTOS 
Standard Software Operations Guide. 

Installing the Editor 

You can install the Editor when you install the operating 
system on your workstation. During BTOS installation, you 
respond to the system's displayed query about installing the 
Editor (refer to the BTOS Standard Software Operations 
Guide). 

However, when BTOS is installed on your workstation and 
the Editor is not, you can install the Editor from the last 
installation diskette of the BTOS series of installation 
diskettes. The diskette is write-protected; you should not 
write-enable it or use it as a working copy. 

To install the Editor on a hard disk system, use the following 
procedure: 

1 Sign on to your workstation and set your path for the 
system directory. 

2 If the system is clustered, disable the cluster (use the 
Executive DISABLE CLUSTER command) or power down the 
other cluster units. 

3 Insert the last BTOS software installation diskette in the 
floppy drive. 

4 Type SUBMIT at an Executive level command prompt, then 
press RETURN. The following Submit form appears with the 
highlight in the File list field. 

Submit 
File list 
[Parameters] 
[Force expansion?] 
[Show expansion?] 



5022072 



1 -4 Overview 

5 Enter the file name [fO]<Sys>Editor.sub and press RETURN. 
The highlight moves to the [Parameters] field. 

6 Enter [Sys]<Sys>Sys.Cmds [Sys]<Sys>; then press GO. 

The system installs the Editor in the [Sys]<Sys> directory, 
and creates the EDIT command in the [Sys]<Sys>Sys.Cmds 
command file. 

Note: If you do not enter the two parameters, the system 
installs the Editor in your current pathed directory. 

When the system finishes software installation, the 
Executive command prompt appears. 

7 Remove the diskette. If your workstation is clustered, you 
can resume cluster operations (use the RESUME CLUSTER 
command). 

The EDIT command is now available at the Executive level; 
you can use the command to enter and edit text. 

Installing the Editor from the XE520 

To install the Editor from the XE520 mainframe computer, 
use the following procedure: 

1 Power down all other cluster workstations of the XE520. 

2 Sign on with the user name ADMIN. 

3 Insert the last BTOS software installation diskette in the 
floppy drive. 

4 Type SUBMIT at the command line, then press RETURN. The 
following Submit form appears: 

SUBMIT 
File List 
[Parameters] 
[Force expansion?] 
[Show expansion?] 

5 Enter the file name [fO]<Sys>Editor.sub and press RETURN. 
The highlight moves to the [Parameters] field. 
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6 Enter [Sys]<Sys>Sys.Cmds [Sys]<Sys>; then press GO. 

The system installs the Editor in the [Sys]<Sys> directory, 
and creates the EDIT command in the [Sys]<Sys>Sys.Cmds 
command file. 

Note: If you do not enter the two parameters, the system 
installs the Editor in your current pathed directory. 

7 Remove the diskette. You can resume cluster operations. 

The EDIT command is now available at the Executive level; 
you can use the command to enter and edit text. 

Preparing an Editor Diskette for a Dual Floppy 
Standalone System 

If you have a dual floppy standalone system, you must 
prepare an Editor diskette. You can then use the EDIT 
command when you insert the diskette in drive fO. 

Note: If you are not familiar with IVOLUME and COPY commands, 
refer to your BTOS Standard Software Operations Guide. 

To prepare an Editor diskette, use the following procedure: 

1 Initialize a diskette. Use standard IVOLUME procedures, but 
enter the following optional parameters (to maximize the 
diskette space available): 

[Log file] 

[Maximum directories] 2 

[Maximum fileis] 15 

[Primary file headers] y 

[Maximum files in system] 12 

For more information on IVOLUME parameters, refer to your 
BTOS Standard Software Operations Guide. 

2 Copy all files from the last BTOS software installation 
diskette to your Editor diskette. 

3 Create a $ directory on your Editor diskette 

(a $ directory name includes three digits; for example, $00 1 ). 

Your Editor diskette is now ready. To activate the Editor, 
refer to section 2. 
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Section 2 2^ 

The Editor Session 

You begin an Editor session by accessing the Executive 
command level (refer to section 1 ), and then executing the 
EDIT command. 

The Editor screen appears. The Editor screen displays text as 
you enter and edit it. 

When you end an Editor session, the system files your work 
if you want it to, and returns to the Executive command 
level. 



Specifying Editor File Names 

When you execute the EDIT command, you must identify a 
text file by name in the Edit form. You can also identify a 
prefix for the typescript (.ts) file for the session. The Edit 
IForm has two fields: 

Edit 
File 
[Your name] 

The File field specifies the file name for the text you create or 
edit in the Editor session. The system uses this file name to 
store, retrieve, write, and read the text you enter under it. 

The [Your name] field specifies a prefix for the typescript (.ts) 
file of the Editor session. The default is xxxx.ts, where xxxx is 
the logged-on user name; if there is no logged-on user and 
you leave this field blank, the default is .ts. 

The system uses this file to recover the text with the REPLAY 
command (refer to Replaying an Editor Session, in this 
section). 

Editor file names should conform to the file name parameters 
for all files. Refer to the BTOS Standard Software Operations 
Guide for further information. Refer also to Storing Editor 
Files, in this section. 

Note: In tiiis guide, keys ttiat you use in combination are 
hyp/ienated. For example, CODE-V indicates that you hold down 
the CODE key and then press the letter V. 

All alphanumeric keys and the DELETE function key have repeat 
action when you hold them down. 
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2-2 The Editor Session 

Beginning an Editor Session 

The Executive command, EDIT, accesses the Editor screen 
and gives keyboard control to Editor operations. To execute 
the EDIT command, you use the following procedure: 

1 Enter the word EDIT in the Executive command field and 
press RETURN. The following Edit form appears with the 
highlight in the File field: 

Edit 
File 
[Your name] 

2 Enter the name of the file you want to edit or create; then 
press RETURN. The highlight moves to the [Your name] field. 

3 To specify a prefix for the typescript (.ts) file associated 
with the file you create or edit, enter a name, 

To accept the default typescript file name, leave this field 
blank. 

The default is xxxx.ts, where xxxx is the logged-on user 
name; if there is no logged-on user and you leave this field 
blank, the default is .ts. 

4 To execute the EDIT command, press GO. If you specify a 
name for which no file exists, the following message 
appears: 

File filename does not exist. Press GO to create or CANCEL to deny. 

To create the file, press GO. 

To change the file name, press CANCEL, press f 1 to edit the 
name, and then press GO. 

The Editor screen appears, displaying the file you specify 
(refer to The Editor Screen, in this section). 

To cancel the EDIT command, press CANCEL. 
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Replaying an Editor Session 



The REPLAY command also activates the Editor. You can use 
the REPLAY command to replay (reenter) the previous session 
whenever a replay is useful; for example, when: 

n the Editor terminates abnormally (a power failure or a disk 
full condition) 

n you want to duplicate entries made in one file into several 
other files 

After the replay, you resume the Editor session. 

The REPLAY command replays the previous session from the 
typescript (.ts) file: a file the system creates during each 
Editor session. 



The Replay Procedure 

To recover your work when the Editor terminates 
abnormally, use the following procedure: 

1 Remedy the cause of the abnormal termination, if 
necessary. For example, if the system displayed a Disk full 
message, you should delete unnecessary files to make 
additional space on the disk. 

2 Copy the Editor session file and its typescript file with the 
Executive COPY command. 

3 Enter the word REPLAY in the Executive command field. The 
following Replay form appears, with the highlight in the File 
field: 

Replay 
File 
[Your name] 

4 Enter the file name (the same file name or a new file name 
on which to save the replay session) and press RETURN. 
The highlight moves to the [Your name] field. 

5 If you specified a typescript file prefix for the session you 
are replaying, enter that prefix. If not, leave the field blank. 
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2-4 The Editor Session 

6 Press GO. The Editor screen appears displaying the replay 
of the previous Editor session. 

7 To suspend the replay, press CANCEL. The system displays 
the message Replay suspended. To resume the replay after 
suspending it, press GO. 

To stop replay and resume editing, press CANCEL twice. 
The remainder of the replay session is lost. 

The Editor Screen 

The Editor screen appears after you execute the EDIT 
command and fills the physical screen, dividing it into three 
parts by a double highlighted line (refer to figure 2-1): 

n the status frame the top screen line where the 

Editor version number, cursor 
file position, and Editor 
messages display 

D the message frame the second line where the name 

of the file being edited displays 
(only on some models of 
workstations) 

n the text frame the remainder of the screen 

where text displays as you 
enter and edit it 

The Editor screen also contains: 

a a cursor that marks the point of your next text entry or 
operation 

D an end-of-file symbol (a hollow square) that marks the end 
of the displayed file 

When you activate Editor commands that have forms and 
require input, and when you display Editor commands, the 
system overlays the bottom lines of the text frame with a 
command area (refer to figure 2-1). The command area 
temporarily hides your text, if any. 

To display the Editor screen, refer to Beginning an Editor 
Session, in this section. 



Figure 2-1 Sample Editor Screen 
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The Editor Session 



Entering Text 



Using the keyboard's alphanumeric keys and Spacebar, you 
can enter text in two modes: 



D insert mode 



D overtype mode 



the OVERTYPE keytop light is out; 
within existing text, characters you 
enter move existing characters to 
the right 

the OVERTYPE keytop light is on; 
within existing text, characters you 
enter replace characters 



When necessary, the text in a line automatically wraps to the 
next line. 



Deleting Text 

You can delete text with two keys and one key combination 
(characters to the right of and below deleted text move to fill 
the space of deleted text): 



DELETE 



D BACKSPACE 



D CODE-DELETE 
orflO 



deletes the character above the 
cursor; deleting the last character 
on one line pulls up the characters 
from the following line 

deletes the character to the left of 
the cursor when the system is in 
insert mode (moves the cursor to 
the left without deleting in 
overtype mode) 

backspacing at the left edge of the 
text frame wraps to the last 
character of the preceding line 

deletes selected text (refer to 
Selecting Text, in section 3) 
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Moving the Cursor 

The cursor is a blinking underline that marks the point of your 
next text entry or edit operation (cursor movement does not 
affect text). 

The cursor moves as you enter and delete text and perform 
other editing operations. In addition, you can move the 
cursor with the direction keys and some key combinations 
(refer to table 2-1). 

You can move the cursor to a space below the end of the 
file to enter text or perform an edit operation. When you do 
this, the system: 

n inserts line feeds for every line between the cursor and the 
end of previous text 

D fills the line the cursor is on with spaces, if necessary 

n moves the hollow square symbol to the new end of the 
text 

When you move the cursor beyond the right or left frame 
margins, it wraps to the opposite side on the same line. 
Similarly, when you move the cursor beyond the top or 
bottom screen lines, it reappears at the opposite end of the 
screen in the same column. 

Table 2-1 Keys that Move the Cursor 

Key Moves the Cursor 

Right Arrow right one character 

Left Arrow left one character 

Up Arrow up one line 

Down Arrow down one line 

SHIFT-Right Arrow five characters to the right 

SHIFT-Left Arrow five characters to the left 

SHIFT-Up Arrow up three lines 

SHIFT-Down Arrow down three lines 

TAB eight characters to the right 

CODE-Right Arrow to the right end of text line 

CODE-Left Arrow to left edge of line 

CODE-Up Arrow to top line of frame 

CODE-Down Arrow to bottom line of frame 
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The Editor Session 



Displaying Text 

The Editor provides you with several options for text display 
(refer to table 2-2). They include: 

n scrolling by line, line group, and page 

D viewing formatting characters and the Editor command list 

n accessing text at a specific percentage position relative to 
total text length 

n adjusting text frame width 

Table 2-2 Keys for Displaying Editor Text 



Keys 

SCROLL UP 
SCROLL DOWN 
SHIFT-SCROLL UP 
SHIFT-SCROLL DOWN 
CODE-N 

NEXT PAGE 
PREV PAGE 
CODE-n (0-9) 



CODE-J 



CODE-V 



HELP 



CODE-Z 



Action 

scrolls text up one line 

scrolls text down one line 

scrolls text up ten lines 

scrolls text down ten lines 

the NORMALIZE command: moves text so that the cursor is 
halfway between the bottom and top of text frame (text can be 
selected or not) 

displays next page (bottom two screen lines become top two 
screen lines) 

displays previous page (top two screen lines become bottom 
two screen lines) 

displays text at a specific percentage of text's length according 
to the formula, n * 1 1 %; for example, 

CODE-0 = 0% (start of file) 

CODE-9 = 99% (end of file) 

CODE-5 = 55% (middle of file) 

the JUMP command: moves text so that the cursor is at a 
specific percentage of the text's total length (refer to The 
JUMP Command Procedure, in this section) 

the VISIBLE command: alternates between displaying and not 
displaying formatting characters (line feeds, tabs, and spaces) 

the HELP command: displays the Editor command list (press 
CANCEL to dismiss) 

the ZOOM command: alternates between text frame widths of 
80 and 132 (only on workstations with the zoom capability) 
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The JUMP Command Procedure 

With the JUMP command, you can move text so that the 
cursor is within a specific percentage of the text's total 
length. You use the following procedure: 

1 Press CODE-J. The following Jump form appears in the 
command area with the cursor in the Percent: field: 

Jump 
Percent: <> 

2 Enter a number from through 99 that represents the 
percentage position in relation to the file's total length (for 
example, 50 would specify the middle of the text file). 

3 Press GO. The Jump form disappears, and the system 
displays the cursor at the text position you specify. 

To cancel the command, press CANCEL. 

Repeating Edits 

You can repeat entries and command operations immediately 
after you finish them by pressing the REDO key, f 1 . For 
example, you press REDO to find successive occurrences of 
the same text with the FIND command. 

The system treats the CODE-DELETE (or flO) operation and 
subsequent insertion of text as a unit for the REDO command. 

Canceling Edits 

By pressing CANCEL, you can cancel entries and command 
operations immediately after you finish them. For example, 
you press CANCEL to restore text you delete (the system 
treats the CODE-DELETE (or flO) operation and subsequent 
insertion of text as a unit in a selected text deletion). 
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2-10 The Editor Session 

Closing an Editor Session 

You close an Editor session with the FINISH command, using 
the following procedure: 

1 Press the FINISH key. The following Finish form appears in 
the comrhand area with the cursor in the Save? field: 

Finish 
Save? <> 

2 To save (file) the session's entries, go to step 3, or type y 
for yes (the default). 

To exit the Editor without saving the session's entries, 
type n for no. 

3 Press GO to exit the Editor. The Executive command 
prompt replaces the Editor screen, and the system files 
your entries if you instruct it to. 

To cancel the command, press CANCEL. 

Terminating the Editor Abnormally 

if you do not use the FINISH command to terminate the 
Editor, an abnormal termination occurs. ACTION-FINISH causes 
an abnormal termination. The Executive command line 
replaces the Editor screen, and the system displays an 
appropriate message. 

To recover entries when an Editor session terminates 
abnormally, use the REPLAY command (refer to Replaying an 
Editor Session, in this section). 



Storing Editor Files 

When you respond yes to the Save option in the FINISH 
command, the system saves your entries on a disk file with 
the file name you specified in the EDIT command form at the 
beginning of the session. (It also saves a typescript (.ts) file 
of the session; refer to Specifying Editor File Names, in this 
section.) 
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If a disk file of the same name exists, the system 
automatically appends -Old to it. You can access the -Old file 
by specifying the file name with the suffix in the EDIT 
command form. The system retains only the most recent 
previous version of any file. 

Refer to the BTOS Standard Software Operations Guide for 
further file information. 
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Advanced Editing Operations 

The Editor application provides editing operations that allow 
you to make major changes in text efficiently. These 
operations include: 

D selecting text 

D searching for text strings 

n searching for and replacing text 

D copying disk file text to Editor screen text and vice versa 

D inserting hexadecimal values 

Note: In this guide, /<eys that you use in combination are 
hyphenated. For example, CODE-V indicates that you hold down 
the CODE key and then press the letter V. 

Selecting Text for Editing 

The Editor allows you to select any amount of continuous 
text. The system treats the selection as a unit for editing 
operations, such as move, copy, or delete. The system 
highlights text you select. 

Table 3-1 shows the types of selection available and how to 
make them. 

Table 3-1 Types of Text Selection 



Selection Type 


Key 


Character Selection 


Mark 


MARK 


from cursor to end of line 


Word Mark 


MARK-Up Arrow 


word containing the cursor and 
the space following it 


Line Mark 


MARK-Right Arrow 


line containing the cursor 


Entire File 


CODE-E 

(EVERYTHING 

command) 


entire file in memory 
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Changing a Selection 

You can reduce or expand a text selection after you make it 
by using the following procedure: 

1 Move the cursor to the position where you want the 
selection to end. 

2 Press BOUND. Selection adjustment depends on your 
original selection type: 

n mark selection stops at the cursor 

position 

n word mark selection includes the word 

containing the cursor 

D line mark selection includes the line 

containing the cursor 

n entire file selection stops at the cursor 

position 



Canceling a Selection 

To cancel a selection after you make it, use the following 
procedure: 

1 Move the cursor into the highlighted selection. 

2 Press MARK-BOUND. The highlight disappears except for the 
character above the cursor. 

3 To eliminate the cursor character highlight, press OVERTYPE 
or DELETE and retype the character. 



Deleting a Text Selection 

To delete a text selection, use the following procedure: 

1 Select the text. 

2 Press CODE-DELETE or flO. The highlighted text disappears. 

You can retrieve deleted text by p^ressing CANCEL 
immediately after deleting the text and/or typing other text 
in its place (the system treats these operations as a unit in 
a selected text deletion). 
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Moving and Copying a Text Selection 

You can move and copy text by making a selection first and 
then specifying the location of the moved or copied text; or 
you can specify the new text location before you select the 
text. 

To move and copy text by making the text selection first, 
use the following procedure: 

1 Select the text to move or copy. 

2 Move the cursor to the beginning of the new text location. 

3 Press MOVE or COPY. The system moves or copies text to 
the location you specify. 

To move and copy text by specifying the new location 
before making a selection, use the following procedure: 

1 Move the cursor to the new text location. 

2 Press the MOVE or COPY key, but do not release it. 

3 Select the text to move or copy. 

4 Release the MOVE or COPY key. The system moves or 
copies text to the location you specify. 

Searching for Text 

You execute the FIND command to search the file for a 
specific text string. The search starts at the cursor position, 
and the system matches text without regard for upper- and 
lowercase. You use the following procedure: 

1 Position the cursor where you want the search to start; 
you can also perform this step before step 4 by moving 
the cursor out of the command form into the text frame. 

2 Press CODE-F. The following Find form appears in the 
command area with the cursor in the String: field: 

Find 
String: < > 

3 Enter the text string for the search. 
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3-4 Advanced Editing Operations 

4 To execute the command, press GO. The Find form 
disappears, and the system highlights the first occurrence 
of the text string, if any. 

To cancel the command, press CANCEL. 

5 To continue the search, press the REDO key (f1). The 
system highlights the next text string occurrence. 

To alter the text string, enter editing changes. To resume 
the search after you edit, repeat steps 2 and 4. 

To remove the last highlight from the search string, use 
the procedure under Canceling a Selection, in this section, 
or overtype the highlighted' text. 

Searching and Replacing Text 

The SUBSTITUTE command allows you to search for a specific 
text string and replace it with another text string. The 
system matches text without regard for upper- and 
lowercase. You use the following procedure: 

1 Select the text for the substitute operation; you can 
perform this step before step 5 by moving the cursor out 
of the command form into the text frame. 

2 Press CODE-S. The following Substitute form appears in the 
command area with the cursor in the New: field: 

Substitute 
New: <> 
Old: <> 

3 Enter the text you want to replace existing text; then press 
NEXT. The cursor moves to the Old: field. 

4 Enter the text you want to replace. 

5 To execute the command, press GO. The Substitute form 
disappears, and the system searches for and replaces the 
text you specify. 

To cancel the command, press CANCEL. 
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Copying from a Disk File to the File in Memory 

The READ command allows you to copy characters from a 
disk file into the file in memory, starting the copy at the 
cursor position. 



Caution: When you execute the READ command, the system 
opens the disk file and sets up a pointer to the text you 
specify to be copied. Therefore: 

D If the file is on a floppy disk, you must finish the Editor 
session before you remove the disk. 

n Because the file remains open until you end the session, 
you cannot write to it with the WRITE command in this session. 

You use the following procedure: 

1 Position the cursor at the destination location for the 
copied text; you can also perform this step at some other 
point before step 6 by moving the cursor out of the 
command form into the text frame. 

2 Press CODE-R. The following Read form appears in the 
command area with the cursor in the File: field: 

Read 
File: < > 

Number of Characters: < > 
Position: < > 

3 Enter the name of the file from which you want to copy 
text; then press NEXT. The cursor moves to the Number of 
Characters: field. 

4 To copy the entire file, go to step 5. 

To copy all text from the starting position (specified in 
step 5), leave this field blank. 

To specify the number of characters to copy, enter a 
number; then press NEXT. The cursor moves to the Position: 
field. 

The system numbers file characters from (the first file 
character); you must manually count the number of 
characters you want to copy. 
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5 To start text copy from the beginning of the file, leave this 
field blank. 

To specify the character you want to start copied text 
with, enter a number. 

You must manually count the number of characters from 
the first file character (0), and enter the number of the 
starting character. 

6 To execute the command, press GO. The Read form 
disappears, and the system copies the text you specify, 
highlighted, into the file on the Editor screen. 

To remove the highlight from the selection, follow the 
procedure under Canceling a Selection, in this section. 

To cancel the command, press CANCEL. 

Copying from a File in Memory to a Disk File 

The WRITE command allows you to copy selected text from 
the Editor screen to a disk file. You use the following 
procedure: 

1 Select the text you want to copy (refer to Selecting Text 
to Edit, in this section). You can also perform this step 
before step 4 by moving the cursor out of the command 
form into the text frame. 

2 Press CODE-W. The following Write form appears in the 
command area with the cursor in the File: field: 

Write 
File: <> 

3 Enter the name of the file you want to copy text to. 

4 To execute the command, press GO; The Write form 
disappears, and the system copies the selected text to the 
disk file you specify. 

To cancel the command, press CANCEL. 
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Inserting Hexadecimal Values 

The INSERT command allows you to insert a byte whose 
code is a specified hexadecimal value. For example, to insert 
a division sign (^) into the text, you insert the hexadecimal 
value of 15. You use the following procedure: 

1 Position the cursor at the location for the insertion; you 
can also perform this step before step 3 by moving the 
cursor out of the command form into the text frame. 

2 Press CODE-I. The following Insert form appears in the 
command area with the cursor in the Code: field. 

Insert 
Code: <> 

3 Insert the hexadecimal value for the byte. 

4 To execute the command, press GO. The system inserts 
the character defined by the hexadecimal code you 
specify. 

To cancel the command, press CANCEL. 
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Status and Error Messages 

Editor status and error messages that display in the message 
frame assist you with Editor operations. Table A-1 lists 
messages and provides additional information to help you 
solve a problem. 

Table A-1 Status and Error Messages 



Message 
Bad length 



Bad position 



Cannot edit there 
Cannot select there 



Cannot open file 



Cannot put 



Cannot write on that file 



Choose a frame 



Disk full, 
please finish 



lliegal action 



Explanation/Action 

In the READ command form, the specified number of 
characters, plus the position, exceeds file length. 
Verify the parameter information, and reactivate the 
command. 

The position specified in the READ command form is 
beyond the end of the file. Verify the starting 
character position, and reactivate the command. 

You attempted to edit outside the text frame and 
command form. Move the cursor to an acceptable 
editing location. 

You cannot open the specified file for reading or 
writing. Either the file is already open or it does not 
exist. Verify the file's status (you cannot 
simultaneously read and write a file). 

The file you are editing and its old version are 
already open. Write the entire file to a new file 
name, selecting it with the EVERYTHING command 
first; then rename it. 

You cannot write in the file specified in the WRITE 
command form. The file may be write-protected or 
the disk may be full. Specify a different file or clear 
some disk space. 

You pressed a key (such as SCROLL UP or NEXT 
PAGE) that requires the cursor to be in the text 
frame. Move the cursor to the text frame. 

Disk storage space is low. Save your file 
immediately. If you cannot save, create disk space by 
deleting unneeded files, then replay the session with 
the REPLAY command. 

You pressed one or more keys that cannot operate at 
this point in your session. 
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Status and Error Messages 



Table A-1 Status and Error Messages (continued) 



Message 

Memory low, 
please finish 



Next not legal 

No form 

No such command 

Not found 



Nothing selected 

Nothing to write 

Replay complete 
Replay suspended 



Explanation/Action 

Memory storage is low. You can free memory by 
saving the file and reentering the Editor. 

A large text selection during the SUBSTITUTE 
operation can cause this message. Substitute a 
sequence of smaller selections. 

You pressed NEXT when the cursor was not in a 
form field. 

You pressed GO without completing a command form. 

You pressed one or more keys that cannot operate at 
this point in your session. 

The system could not find the text specified in the 
Find form. Either the text does not exist or it is 
located prior to the cursor's position when you 
executed the FIND command. 

You specified a command (such as MOVE or COPY) 
that requires a text selection, and no selection exists. 
Select text and repeat the command. 

The WRITE command has nothing to write. Select 
text and repeat the command. 

Replay is finished; you can resume Editor operations. 

You pressed CANCEL during a Replay operation. 
Press GO to continue the Replay operation, or press 
CANCEL again to stop it and resume normal editing. 
When you begin normal editing, the remainder of the 
Replay operation, if any, is lost. 
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Editor Command List 

Table B-1 lists and explains Editor commands alphabetically. 
Table B-1 Editor Commands 



Command 


Key 


CANCEL 


CANCEL 


EVERYTHING 


CODE-E 


FIND 


CODE-F 


FINISH 


FINISH 


HELP 


HELP 


INSERT 


CODE-I 


JUMP 


CODE-J 



NORMALIZE CODE-N 



READ 



REDO 



VISIBLE 



WRITE 



ZOOM 



CODE-R 



SUBSTITUTE CODE-S 



CODE-V 



CODE-R 



CODE-Z 



Action 

reverses the most recent entry or edit 
operation 

selects entire file in memory 

searches for a text string 

ends an Editor session 

displays an Editor command list 

enables insertion of a hexadecimal value 

moves text so that the cursor is at a specific 
percentage of the text's total length 

moves text so that cursor is halfway between 
bottom and top of text frame 

copies characters from a disk file to a file in 
memory 

repeats the most recent entry or edit 
operation 

searches for a text string and replaces it with 
another text string 

alternates between displaying and not 
displaying formatting characters 

appends selected text from a file in memory 
to a disk file 

alternates between text frame widths of 80 
and 132 columns (only on workstations 
with the zoom capability) 
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Glossary 

BTOS. BIOS is an acronym for Burroughs Operating System. 

Command Area. The command area is the last few lines of the Editor screen that 
displays the command list when you activate the HELP command, and where command 
forms appear. The command area temporarily obscures text at the bottom of the 
screen. 

Cursor. The cursor is a blinking underline that, marks the point of your next keyboard 
text entry or operation. 

Editor. The Editor is a software application that allows you to enter and edit text 
using the workstation keyboard. 

Editor Screen. The Editor screen is the display area of the Editor application. It 
consists of the status frame and the text frame. 

End-of-file Symbol. The end-of-fiie symbol is a hollow square that marks the end of 
text in memory on the Editor screen. 

File l\lame. A file name is the text string that identifies documents that you create 
and store on your workstation's disk. 

Hexadecimal. Hexadecimal refers to a base 16 number system that employs two 
alphanumeric characters to identify numbers, letters, and other characters to the 
operating system. 

Insert Mode. When the system is in insert mode, it automatically moves existing 
characters and spaces to the right to make room for inserted characters and spaces. 
The system is in insert mode if the red light on the OVERTYPE key is not lit. The 
system is normally in insert mode when you first turn it on. 

Keyboard. For text entry, the keyboard includes ail the keys found on a standard 
typewriter. In addition, the keyboard has many function keys for performing word 
processing operations. 

Message Frame. The Message Frame is the second line of the Editor screen where 
the name of the file being edited displays (on certain models of workstations only). 

Overtype Mode. When the system is in overtype mode, it automatically replaces 
existing characters and spaces with other characters and spaces as you enter them. 
The system is in overtype mode when the red light on the OVERTYPE key is lit. 

Path. The path identifies the volume and directory upon which the system acts. You 
identify it with the Executive PATH command, entering the volume name in square 
brackets and the directory name in angle brackets. 

Status Frame. The status frame is the top line of the Editor screen that displays the 
Editor version number, cursor file position, and system messages. The name of the file 
on the Editor screen also displays on this line (on certain models of workstations 
only). 
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Text Frame. The text frame is the major portion of the Editor screen where you enter 
and edit text. 

Typescript File. A typescript file (.ts) is a file created by the Editor. It contains the 
typescript for an Editor session, and is the file that the REPLAY command uses to 
replay the session. 
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Abnormal termination of the Editor, 2-10 
Accessing the Executive command level, 1-2 
Advanced Editor operations, 3-1 

Beginning an Editor session, 2-2 

BIOS, C-1 

BIOS SignOn form, 1-2 

CANCEL command, 2-10, B-1 
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a selection, 3-2 

edits, 2-9 
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a selection, 3-2 

the path, 1-2 
Closing an Editor session, 2-10 
CODE-DELETE keys, 2-6 
CODE-Down Arrow keys, 2-7 
CODE-J keys, 2-8 
CODE-Left Arrow keys, 2-7 
CGDE-n (0-9) keys, 2-8 
CODE-Right Arrow keys, 2-7 
CODE-Up Arrow keys, 2-7 
CODE-V keys, 2-8 
CODE-Z keys, 2-8 
Command area, 2-4, C-1 
Command list, B-1 
Copying 

a text selection, 3-3 

from a disk file to the file in memory, 3-5 

from a file in memory to a disk file, 3-6 
Cursor, 2-4, C-1 

keys that move the, 2-7 

moving the, 2-7 

Deleting 

a text selection, 3-2 

text, 2-6 
Displaying text, 2-8 
Down Arrow key, 2-7 
Dual floppy standalone 

preparing an Editor diskette for a, 1-5 

EDIT command, 1-4, 2-1, 2-4 
Editing 

selecting text for, 3-1 
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Editor, C-1 

abnormal termination of the, 2-10 

command list, 6-1 

file names, 2-1 

form, 2-1 

installing the, 1-3 

screen, 2-4, C-1 
Editor files 

storing, 2-10 
Editor operations 

advanced, 3-1 
Editor session 

beginning an, 2-2 

closing an, 2-10 

replaying an, 2-3 
Edits 

canceling, 2-9 

repeating, 2-9 
End-of-file symbol, 2-4, C-1 
Entering text, 2-6 
Error messages, A-1 
EVERYTHING command, B-1 
Executive command level 

accessing the, 1-2 

File name, C-1 

specifying Editor, 2-1 
FIND command, 2-9, 3-3, B-1 
FINISH command, 2-10, B-1 

HELP command, B-1 
HELP key, 2-8 
Hexadecimal values, C-1 
inserting, 3-7 

INSERT command, 3-7, B-1 
Inserting hexadecimal values, 3-7 
Insert mode, 2-6, C-1 
Installing the Editor, 1-3 
from the XE520, 1-4 
Introduction, ix 
IVOLUME command, 1-5 

JUMP command, 2-9, B-1 
JUMP command procedure, 2-9 

Keyboard, C-1 

Keys 

that display Editor text, 2-8 
that move the cursor, 2-7 



Left Arrow key, 2-7 

Message frame, 2-4, C-1 
Modes 

insert, 2-6 

overtype, 2-6 
Moving 

a text selection, 3-3 

the cursor, 2-7 

NEXT PAGE key, 2-8 
NORMALIZE command, B-1 

Operations 

advanced Editor, 3-1 
Overtype mode, 2-6, C-1 
Overview, 1-1 

Path, C-1 

changing the, 1-2 

setting the, 1-2 
Preparing 

an Editor diskette for a dual floppy standalone, 1-5 
PREV PAGE key, 2-8 

READ command, 3-5, B-1 
REDO command, 2-9, B-1 
Repeating edits, 2-9 
REPLAY command, 2-1, 2-3 
Replaying an Editor session, 2-3 
Replay procedure, 2-3 
Right Arrow key, 2-7 

Screen (Editor), 2-4 
SCROLL DOWN key, 2-8 
SCROLL UP key, 2-8 
Searching 

and replacing text, 3-4 

for text, 3-3 
Selecting text for editing, 3-1 
Selection 

canceling a, 3-2 

changing a, 3-2 

copying a, 3-3 

moving a, 3-3 

types, 3-1, 3-2 
Setting the path, 1-2 
SHIFT-Down Arrow keys, 2-7 
SHIFT-Left Arrow keys, 2-7 
SHIFT-Right Arrow keys, 2-7 
SHIFT-SCROLL DOWN keys, 2-8 
SHIFT-SCROLL UP keys, 2-8 
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SHIFT-Up Arrow keys, 2-7 
SignOn form, 1-2 
Specifying Editor file names, 2-1 
Starting an Editor session, 2-2 
Status frame, 2-4, C-1 
Status messages, A-1 
Storing Editor files, 2-10 
SUBMIT command, 1-4 
SUBSTITUTE command, 3-4, B-1 

TAB key, 2-7 

Terminating the Editor abnormally, 2-10 

Text 

entering, 2-6 

deleting, 2-6 

displaying, 2-8 

frame, 2-4, C-2 

searching and replacing, 3-4 

searching for, 3-3 
Text selection 

copying a, 3-3 

deleting a, 3-2 

moving a, 3-3 
Typescript (.ts) file, 2-1, C-2 
Types of text selection, 3-1, 3-2 

Up Arrow key, 2-7 

VISIBLE command, B-1 

WRITE command, 3-5, 3-6, B-1 

XE520 

installing the Editor from the, 1-4 

ZOOM command, B-1 
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